home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / liboil0.3 / README < prev   
Text File  |  2007-11-15  |  3KB  |  71 lines
  1.  
  2.  
  3. Requirements
  4. ============
  5.  
  6. Liboil has no required dependecies (other than a decent C compiler
  7. and standard C library).  A few extra tests and examples are enabled
  8. if you have glib-2.0 installed, but these extras are neither required
  9. nor installed.
  10.  
  11. Using GCC is strongly recommended, since the most interesting bits
  12. of liboil are written in GCC-style inline assembly.  GCC versions
  13. prior to 3.4 are not supported.
  14.  
  15.  
  16. Problems Compiling?
  17. ===================
  18.  
  19. Function implementations in liboil are designed to be modular, so
  20. if your compiler is having difficulty compiling a particular function,
  21. simply disable it and the corresponding OIL_DEFINE_IMPL() line.
  22.  
  23.  
  24. ABI warning
  25. ===========
  26.  
  27. Only a portion of the liboil API is ABI stable.  This portion is
  28. guaranteed to be stable through the 0.3.x series, and by using
  29. a compatibility library, through the 0.4.x series as well.  This
  30. policy is designed to provide almost all applications the necessary
  31. ABI stability for the symbols likely to be used in liboil.
  32.  
  33. Any symbols declared by including <liboil/liboil.h> follow this
  34. ABI policy.  This includes all liboil function classes as well
  35. as a limited number of core functions, such as oil_init().
  36.  
  37. Functions defined in other header files should not be used.
  38.  
  39.  
  40. ABI Implementation
  41. ==================
  42.  
  43. The liboil-0.3.x series create the shared library liboil-0.3.so.
  44. Applications that use liboil are linked against this library, and
  45. will load liboil-0.3.so at runtime.
  46.  
  47. The liboil-0.4.x series will create two shared libraries,
  48. liboil-0.4.so and a compaitiblity library liboil-0.3.so that
  49. implements functionality removed in the 0.3->0.4 transition.
  50. The 0.3 shared library will be binary compatible with the
  51. liboil-0.3.x releases.  Thus, applictions compiled with a
  52. liboil-0.3.x release will continue to function after the shared
  53. library is upgraded to a 0.4.x release.  Applications compiled
  54. with 0.4.x will use liboil-0.4.so directly.
  55.  
  56. Distributions can use this compatibility library in order to
  57. smooth transitions between liboil major releases.  For example,
  58. consider the case where AppA depends on libB and libC, and both
  59. libraries use liboil.  When liboil-0.4 is released, the distro
  60. can start using it immediately, and AppA will continue to work
  61. correctly.  Then, at a convenient time, libB and libC can
  62. independently be recompiled using liboil-0.4.x, and the packages
  63. will no longer depend on liboil-0.3.so.
  64.  
  65. The traditional way of dealing with these changes is to migrate
  66. all packages to the new library as quickly as possible.  This is
  67. unduly cumbersome.
  68.  
  69.  
  70.  
  71.